DIAL

  .  Summary

  dial(str <dialstr>, int <maxtries>, int <no_link>);

  .  Description

  The dial function dials the entries specified in <dialstr>. The en-
  tries should be entered in the same format as used when typing en-
  tries in the dialing directory. If <dialstr> is empty (""), the di-
  aling directory is displayed. <maxtries> is the maximum number of
  dialing attempts. For example, if the string contains one entry, and
  <maxtries> is equal to 5, Telix will attempt to dial the number 5
  times. If five entries are indicated, and <maxtries> is equal to 5,
  each number will only be attempted once.  If <maxtries> is 0, dial-
  ing will continue until a connection is established. If an entry is
  connected to, and has a linked script file attached, that script
  will be run, unless <no_link> is non-zero (TRUE).

  .  Return Value

  If there was a connection, the dial function returns the entry num-
  ber of the entry which was connected to (or 1 if a manual number was
  dialed). If there was no connection established, 0 is returned. If
  the <dialstr> has a bad format, -1 is returned.
  Also, when a connection is successfully established, the entry num-
  ber of the entry connected to is placed in the system variable
  _entry_enum, while the name of the entry connected to is placed in
  the system variable _entry_name.

  .  Example

  int stat;
  dial("10 15", 0);
  dial("m967-1111", 5);
  stat = dial(number_list, 0);